%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%                                                           %
% UniTerm Users Guide, Copyright 1986, 1987 Simon Poole     %
%                                                           %
% This file may not be changed without permission, all      %
% rights reserved.                                          %
%                                                           %
% Simon Poole                                               %
% Bahnhofstr. 51 b                                          %
% CH-5430 Wettingen                                         %
% Switzerland                                               %
%                                                           %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{More About UniTerm}

This chapter contains a short description of all user-setable parameters,
except those related to the various file transfer protocols. 
Please  read  the chapter~\ref{ftref} for more information.  

\section{RS232 Port Parameters}\index{RS232 Port Parameters}      

   To change  these  settings, press \key{Help}\ and select \button{RS232}\ from
the \button{Settings}\ menu.  Following parameters can be changed: 

\begin{description}
\explain{Baud}{selects the rate for the serial port.}  
\explain{Flowcontrol}{selects the  flowcontrol   mode,   these 
                      functions are implemented by the BIOS.}  
\explain{Parity}{selects  the  parity mode,  these  modes  are 
                         implemented by the BIOS\footnote{Basic Input Output System}.}  
\explain{Databits}{allows  you to select the number of data 
                            bits, implemented by the BIOS.} 
\explain{Stopbits}{allows  you to select the number of  
                             stop bits, implemented by the BIOS.} 
\explain{Mode}{allows you to put the terminal in one of following 
                modes:
         
         \begin{description} 
         \item [\button{Full}]  \parbox[t]{2.5in}{Data  typed on the 
                                       terminal is echoed by  the 
                                       host computer\footnotemark.}      
         \item [\button{Echo}]  \parbox[t]{2.5in}{UniTerm  echos  user  
                                             input  on  the  screen.}       
         \item [\button{Local}] \parbox[t]{2.5in}{User input is only 
                                              sent to the screen.}
         \end{description}}  
\end{description}
\footnotetext{to stop people always asking what the ``Full'' string in the statusline
means; ``Online'' is displayed instead}
\section{Terminal Parameters}       


    To  change   these   settings,    press   \key{Help}\  and  select  
\button{Terminal 1}\  or  \button{Terminal 2}\  from  the \button{Settings}\
menu, the following parameters can be changed: 

\subsection{Terminal 1}
\begin{description}
\explain{Terminal}{selects   the  terminal mode and  change  the 
                   terminal  identification.  \button{4014}\ selects  4014 
                   alpha mode, \button{DCM}\ selects Display Control Mode\footnotemark\index{Display Control Mode}} 
\explain{Keypad}{chooses   the   mode  of   the   keypad,   in 
                   application mode escape sequences are sent by 
                   all keys, in numeric mode only the top 4 keys 
                   send escape codes (they are the keys F1 to F4 
                   on a real VT100).}
\explain{Cursormode}{selects  the  two different  sets  of  escape 
                   sequences  that  can be sent  by  the  cursor 
                   keys.}
\explain{Use }{masks  out  the 8th bit of sent  or  received 
                   bytes for the terminal emulations,  set to  8 
                   bits if you want to use the 8 bit VT2XX  mode 
                   (this  only effects ASCII file  transfer  and 
                   not the other file transfer modes).}  
\explain{Scroll}{selects between slow and quick scroll.}  
\explain{Newline Mode}{sets the VT100/102/200 newline mode (what  is 
                   sent when you press \key{Return}).}
\explain{Wrap}{switches the automatic wraparound at the  end 
               of a line on and off.}
\explain{Cursor}{selects blinking or non  blinking,  underline 
                 or block cursor.}
\explain{Background}{sets the background (and naturally the foreground)
                     color}                     
\explain{Delete}{changes the way \key{Backspace}\ and \key{Delete}\ work,
              if set to \button{Delete}\ \key{Backspace}\ will send
              \ASCII{BS}\ and \key{Delete}\ will send \ASCII{DEL},
              set to \button{Backspace}\ the codes are exchanged.}  
\end{description}
\footnotetext{All control codes are displayed on the screen, instead of
causing a screen operation}
\subsection{Terminal 2}
\begin{description}
\explain{Answerback}{is  the  string which is sent  as  answerback 
                     message.}  
\explain{Printer}{determines if a printer is connected or not.}
\explain{Print terminator}{determines if a \ASCII{FF}\ is sent after  each 
                        print operation or not.}  
\explain{SLE}{turns the built-in single-line editor on  and off.}
\explain{Auto executed macro}{The contents of any file named here, are
                              executed on startup by the \UniTerm\ macro
                              processor}
\explain{NRC}{turns national replacement character set mode on, and controls
              which character set is used (selecting ASCII turns it off).}\footnotemark
\end{description}
\footnotetext{Use this mode only  if you are using UniTerm in a 7-bit 
              enviroment, normally you should use the 8-bit character set
              for this.}


\section{Graphics Terminal Parameters}    
   
 Select \button{Graphics} from the \button{Settings} menu to change the  parameters 
of the graphic terminal module: 
\begin{description}
\explain{Tektronix mode}{enables  or disables automatic  switching  to 
                   the  Tektronix  mode  after  a   \ASCII{GS} 
                   character,  useful  on noisy telephone  lines 
                   (this option also inhibits the allocation  of 
                   a 32kB buffer for the Tektronix screen).} 
\lexplain{GIN Termination String}{sets the string sent after a GIN report.}  
\lexplain{Status Termination String}{sets the string sent after a status report.}  
\explain{Aspect}{this option controls the scaling of pictures.}  
\explain{Deletes}{allows you to set processing of \ASCII{DEL}\ in  the 
                        4010 module.}
\end{description}

\section{Tabs}\index{Tabs}

This small dialog allows you to set the tab positions. Generally it is
not a good idea to change them from the default settings, since there
is a lot of (buggy) software that relies on the settings being the same
as the original VT100 factory settings.

\section{Changing Buffer Sizes}\index{Buffer Sizes} 

  Select  \button{Buffers}\ from the \button{Settings}\ menu,  the top  half  of  the 
dialog form allows you to change four values:
\begin{itemize}
\item Transfer buffer size
\item RS232 input buffer size
\item System reserved size
\item Clipboard size
\end{itemize}
the   \button{$+$}\   and  the  \button{$-$}\   buttons   autorepeat,   
double   clicking  increases (decreases) the displayed  value by 1000. 

In the bottom half the actual amount of memory allocated to  each 
buffer is displayed, if these values are not the same as the ones 
set  by  you,  for some reason UniTerm was not able to  use  your 
configuration.  In this case 5kB are reserved for system use, 2kB
for the clipboard and the rest of available memory is allocated to 
the transfer buffer  (up to the amount set by you,  minimum 1kB),
the remaining  memory is used by the history buffer (min. 1kB).

The RS232 buffer values will only change if you save the value in 
a setup file and restart UniTerm,  all other changes take  effect 
immediately (and reset the buffers!). 


\section{Setup Files}\index{Setup Files}       


  All  user  setable parameters are stored  in  the  setup  files 
(including the function key strings etc.).  Loading a setup  file 
from  a different version  of  UniTerm  may result in  a  version 
conflict  error   message,  if  this  happens  UniTerm  uses  its 
internal defaults.  

\section{File Capture/Playback}\index{File Capture}\index{File Playback}       


   The file capture routine uses a character  translation  table, which 
can be edited by selecting \button{ASCII}\ from the \button{Transfer}\  menu 
and then selecting \button{File Transfer}\ from the \button{Settings}\ menu.

   While  file  capture  is in  progress  all  screen  output  is translated 
too,  so you will get a direct impression of what  you are saving.

   The  Playback function allows you to simulate input  from  the serial  
port,  pressing  \key{A}\ allows you to abort\index{abort},  any other  key 
will cause UniTerm to wait for another keypress.  

\section{Editing Function Keys}      


To edit the string assigned to a function key, press the \key{Help}\ key and
select \button{Edit Function Keys}\ from the \button{Other}\ menu.  You can edit  the 
strings now, the cursor keys will move you to the string you want 
to edit,  \key{Esc}\ will clear the string, \key{Backspace}\ will delete to 
the left,  \key{Delete}\ the current character.  Control codes can  be 
entered  by  pressing  \key{Control}\ and  the  appropriate  key  (see 
appendix B).  

\section{The Statusline}\index{Statusline}      

   The  25th line on the screen is used as a statusline  in  text 
terminal   mode,   it  should  look  like  this   (all   possible 
information shown):
\begin{center}
\begin{tabular}{|lllllll|}
\hline 
UniTerm~~&V2.0c~~&Online~~&Meta&Caps&HPDBLCR&1234 \\
\hline\hline
Program  &Version&Mode    &Meta&Caps&Status&LED \\
name     &       &        &Ind.&Ind.&      &    \\
\hline  
\end{tabular}
\end{center}
The ``Status LED's'' are (from left to right): 
\begin{center}
\begin{tabular}{|l|c|c|}
\hline
                & On & Off \\
\hline
History         & H  & \_ \\
Autoprint       & P  & \_ \\
DCD             & D  & \_ \\     
Break           & B  & \_ \\
Keyboard locked & L  & \_ \\
File Capture    & C  & \_ \\
Insert Mode     & I  & R  \\
\hline
\end{tabular}
\end{center}

\section{The Single-line Editor}\index{Single-line Editor}     


   To make  working  on  systems  that  don't  have a single-line
editor  (short  sle)  easier,  a  simple  sle  is  implemented in
UniTerm.  The  last  20  lines  typed by the user are stored in a
circular  buffer.  Pressing  \key{Insert}\  starts the sle, the status
line  will  clear and the current line will be displayed instead.
The following functions are provided:
 
\begin{description}
\expkey{\Rarrow}{move the cursor one character to the right.} 
\expkey{\Larrow}{move the cursor one character to the left.} 
\expkey{\Uarrow}{display the previous line.}
\expkey{\Darrow}{display the next line.}
\expkey{Delete}{delete the character under the cursor.}  
\expkey{Backspace}{delete  the  character to the  left  of  the 
                          cursor.}
\expkey{Insert}{terminate the sle without sending the current line.}       
\expkey{Return}{send the current line and leave the sle.}  
\end{description}

The  sle  is  always  in  insert mode. {\bf DON'T FORGET TO ERASE YOUR PASSWORDS!} 
 If  you  want  to disable the sle  for  this  reason, 
disable it in the \button{Terminal}\ dialog box. 


\section{Single Character Commands}\index{Single Character Commands}

 All functions in the ``Help'' menu of \UniTerm\ can used with single 
character commands:

\begin{center}
\begin{tabular}{cl}
        1 &  Set terminal parameters part 1 \\
        2 &  Set terminal parameters part 2 \\
        A &  Set ASCII file transfer parameters \\
        B &  Set buffer sizes \\
        C &  Configure dialer \\
        D &  Delete file \\
        E &  Edit function-keys \\
        F &  Show free diskspace \\
        G &  Set graphic parameters \\
        I &  Show info dialog \\
        K &  Set Kermit parameters \\
        L &  Load setup \\
        P &  Set path \\
        R &  Run program \\
        S &  Save setup \\
        T &  Set tabs \\
        Q &  Quit ``help'' dialog \\
        V &  Set RS232 parameters  \\
        X,Y & Set X/YModem parameters \\
\end{tabular}
\end{center}

